قیمت‌دهی سفر (Price)

هزینه سفر بر اساس مبدأ و مقصد تعیین می‌شود.

---

اطلاعات عمومی

• آدرس: /api/v3/ride/price
• متد: POST
• نوع محتوا: application/json
• احراز هویت: نیازمند token

---

پارامترهای درخواست

درخواست باید شامل یک شیء JSON با فیلدهای زیر باشد:

فیلد	نوع داده	ضروری	توضیحات
points	array	بله	آرایه‌ای شامل مختصات جغرافیایی مبدا و مقصد
service_types	array	بله	لیستی از انواع سرویس‌هایی که قیمت آن‌ها نیاز است
waiting	integer	خیر	مدت زمان انتظار (در دقیقه)
round_trip	boolean	خیر	آیا سفر رفت و برگشت است؟
voucher_code	string	خیر	کد تخفیف در صورت وجود

---

نمونه درخواست

curl --location 'https://corporate.snapp.site/api/v3/ride/price' \
--header 'accept: application/json, text/plain, */*' \
--header 'authorization: <your_authorization_token>' \
--header 'Content-Type: application/json' \
--data '{
    "points": [
        {
            "lat": 35.7340829,
            "lng": 51.482242
        },
        {
            "lat": 35.70686805699289,
            "lng": 51.337287834599834
        }
    ],
    "service_types": [
        1,
        2,
        7,
        5
    ],
    "waiting": null,
    "round_trip": null,
    "voucher_code": null
}'

---

نمونه پاسخ موفق

{
  "data": {
    "data": {
      "confirm_before_ride": true,
      "confirm_before_ride_message": "string",
      "details": "string",
      "message": "string",
      "prices": [
        {
          "distance": 0,
          "eta": "string",
          "final": 0,
          "final_lower": 0,
          "is_discounted_price": true,
          "is_enabled": true,
          "is_free_ride": true,
          "is_hurry_enable": true,
          "is_post_price": true,
          "is_surged": true,
          "items": [
            "string"
          ],
          "promotion_error": "string",
          "raw_fare": 0,
          "raw_fare_lower": 0,
          "tag": "string",
          "tcv": 0,
          "texts": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "type": "string",
          "voucher_type": 0
        }
      ],
      "tag": "string",
      "waiting": [
        {
          "key": "string",
          "price": 0,
          "text": "string"
        }
      ]
    },
    "status": 0
  },
  "message": "string",
  "status": 0
}

---

توضیحات پاسخ

فیلد	نوع داده	توضیحات
prices	array	آرایه‌ای از قیمت‌های سرویس‌های مختلف
final	integer	قیمت نهایی سفر (به ریال)
type	string	نوع سرویس
is_enabled	boolean	آیا این سرویس در دسترس است؟
waiting	array	لیستی از هزینه‌های انتظار بر اساس زمان

---

کدهای خطا

کد وضعیت	توضیحات
400	درخواست نامعتبر است
404	مسیر یا اطلاعات وارد شده معتبر نیست
412	پیش‌شرط‌های لازم برقرار نیست
500	خطای داخلی سرور

---

نکات تکمیلی

• قیمت تخمینی ممکن است بسته به شرایط ترافیکی و تقاضا تغییر کند.
• در صورت ارسال اطلاعات نامعتبر، پیام خطای مناسب دریافت خواهید کرد.
• فیلد service_types لیستی از شناسه‌های سرویس‌هایی است که کاربر می‌خواهد قیمت آن‌ها را دریافت کند.

---

service_types

شناسه عددی	نام انگلیسی	نام فارسی
1	Eco	اسنپ اکو
2	Plus	اسنپ پلاس
3	Rose	اسنپ رُز
4	Yellow	اسنپ تاکسی
5	Delivery	اسنپ باکس
6	Eat	اسنپ فود
7	Bike	اسنپ بایک
8	CabDelivery	اسنپ باکس با خودرو
9	BoxPlus	اسنپ باکس پلاس
10	BigBox	اسنپ بیگ باکس
11	Van	اسنپ وانت
12	HeavyVan	اسنپ وانت سنگین
31	InterCity	بین شهری